home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / vbbs61a2.zip / VXY.DOC < prev    next >
Text File  |  1993-05-30  |  8KB  |  172 lines
  1.              VXY VBBS Xmodem/Ymodem/Zmodem Transfer Protocols 2.50
  2.                   (C) Copyright Roland De Graaf 1992, 1993
  3.           
  4.           VXY is a file transfer protocol program written specifically 
  5.           for The Virtual BBS/NET 6.10 and up. It provides VBBS with its 
  6.           own set of Xmodem, Ymodem, and now, Zmodem transfer protocols 
  7.           and many of their variants. If you run a multiline VBBS, running 
  8.           2 or more ports off of one machine, then you should take a look 
  9.           at VXY. VXY can also be used as a stand-alone protocol from almost
  10.           any program. (This capability was added so VGIX could make use of 
  11.           VXY for transfer protocols.)
  12.  
  13.                             ========================
  14.                             Using VXY with your VBBS
  15.                             ========================
  16.           
  17.           VXY uses the *exact same* method of accessing the serial 
  18.           ports as does the main VBBS program. VXY follows your VBBS 
  19.           configuration. If you are set to use internal serial 
  20.           routines, then VXY will use internal routine. If you are
  21.           set to use a FOSSIL, then VXY will use the FOSSIL. If you 
  22.           are set for DigiBoard, VXY will work thru your DigiBoard.
  23.  
  24.           Therefore, if you've got some type of weird serial port 
  25.           set-up, which runs OK with VBBS, it will run OK with VXY. 
  26.           VXY can be used in situations where DSZ is *not compatible. 
  27.           VXY is also sensitive to Desqview, Windows, OS/2 and other
  28.           'INT 2F compatible' multitaskers.
  29.  
  30.           (When used with VBBS, make sure the proper switch turned on 
  31.           in VCONFIG.)
  32.           
  33.           If you installed VBBS as a new installation, VXY is already
  34.           configured for you as part of the default configuration files,
  35.           along with DSZ.
  36.  
  37.      **NOTE: A transfer in progress can be aborted by pressing the Esc key.
  38.  
  39.         **SPECIAL NOTE ABOUT USING VXY FOR NETWORKING:
  40.           
  41.           VXY is the protocol package used by the VFIDO Fidonet Mail Package
  42.           during FTS-0001 TSYNC mail sessions. If you run VFIDO, you must
  43.           have VXY.EXE resident on your system.
  44.  
  45.           VXY Ymodem is supported by the new, enhanced VNET program
  46.           in addition to DSZ Zmodem and HSlink. If you are on any
  47.           VirtualNET type networks, you must have VXY.EXE resident on
  48.           your system.
  49.           
  50.           VXY is a very *new program. Please report all discrepancies
  51.           to the author for immediate attention.
  52.  
  53.         Protocols Supported:        VBBS Set-Up:
  54.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  55.         Xmodem                   Sending: VXY %8 -XS %3
  56.                                  Recving: VXY %8 -XR %3
  57.         Xmodem Checksum
  58.         Xmodem CRC
  59.         Xmodem G
  60.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  61.         Xmodem 1k                Sending: VXY %8 -KS %3
  62.                                  Recving: VXY %8 -KR %3
  63.         Xmodem 1k Checksum
  64.         Xmodem 1k CRC
  65.         Xmodem 1k G
  66.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  67.         Ymodem CRC               Sending: VXY %8 -YS %3
  68.                                  Recving: VXY %8 -YR %3
  69.        
  70.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  71.         Ymodem G                 Sending: VXY %8 -GS %3               
  72.                                  Recving: VXY %8 -GR %3                
  73.  
  74.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  75.         Modem7                   Sending: VXY %8 -7S %3
  76.                                  Recving: VXY %8 -7R %3
  77.    
  78.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  79.         Zmodem                   Sending: VXY %8 -ZS %3               
  80.                                  Recving: VXY %8 -ZR %3                
  81.  
  82.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  83.  
  84. **It should be noted, that when sending files, Checksum vs CRC vs G selection
  85.   is made by the receiving end. The "nak" character sent by the receiving end
  86.   dictates the type of error correction: ascii 21 (nak) = Checksum, "C"=CRC,
  87.   "G" = G mode. You need not worry about all of this -- its automatic. This
  88.   information is merely provided for completeness.
  89.  
  90. **Modem7 is a Xmodem-variant that allows for batch file transfer.
  91.   The Virtual BBS FIDOnet Mailer calls VXY for this protocol
  92.   (and the Xmodem protocol) during basic FTS-0001 FIDOnet sessions.
  93.   Many term packages also support this protocol for general BBS use.
  94.                             
  95.                             ===================
  96.                             Using VXY with VGIX
  97.                             ===================
  98.  
  99.           Install VXY.EXE in the same directory where you run VGIX from.
  100.           Thats all there is to it. :)
  101.  
  102.  
  103.                        =============================
  104.                        Using VXY with Other Programs
  105.                        =============================
  106.  
  107.           When using VXY with programs other than VBBS, the 
  108.           command line syntax is as follows:
  109.  
  110.           VXY <port #> /S <options...> <command> <file or path spec>
  111.  
  112.           <port #> is the port number.
  113.           
  114.           /S specifies STAND-ALONE usage (as opposed to VBBS usage.)
  115.           
  116.           <options> 
  117.               
  118.               The default in standalone mode is standard internal COM support.
  119.                 /X instructs VXY to use a FOSSIL driver.
  120.                 /DG instructs VXY to use DigiBoard.
  121.               Multitasker-awareness:
  122.                 /DV Desqview
  123.                 /2F Int 2F compatible multitaskers such as Windows and OS/2
  124.               The default in standalone mode is no flow control.
  125.                 /F turns CTS/RTS flow control ON.
  126.               The default is no sound.
  127.                 /Z enables Sound.
  128.               Other:
  129.                 /R enables Zmodem Crash Recovery when Receiving Files.
  130.                 (Zmodem Crash Recovery when Transmitting is automatic.)
  131.           
  132.           <command> is one of the following:
  133.                     -XS   Xmodem Send
  134.                     -XR   Xmodem Receive
  135.                     -KS   Xmodem 1k Send
  136.                     -KR   Xmodem 1K Receive
  137.                     -YS   Ymodem Send
  138.                     -YR   Ymodem Receive
  139.                     -GS   Ymodem G Send
  140.                     -GR   Ymodem G Receive
  141.                     -ZS   Zmodem Send
  142.                     -ZR   Zmodem Receive
  143.  
  144.           <path or file spec>
  145.  
  146.             Receiving:
  147.               
  148.               If the <path or file spec> ends with a "\" character,
  149.               then VXY assumes that this is a path specification,
  150.               otherwise it assumed to be a filename.
  151.               
  152.               Xmodem, Xmodem 1k    Requires a Filename
  153.               Ymodem, Zmodem       Can take a Pathname or Filename
  154.                                    (If none is specified, the current
  155.                                    directory is assumed.)
  156.             Sending:
  157.               
  158.               For sending, a filename is required.
  159.               If you precede the filenamne with a "@" character,
  160.               then VXY assumes that this specifies a ascii file
  161.               containing a list of files to be transmitted.
  162.  
  163.  
  164.          *********************************************************
  165.          VXY is copyrighted shareware, and as such this program
  166.          may be freely distributed in its original form only.
  167.          The author makes no warranty, expressed or implied, with
  168.          regards to claims of loss or damages arising from the use
  169.          of this software.
  170.          *********************************************************
  171.  
  172.